home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / SLGetSpooler.z / SLGetSpooler
Text File  |  1998-10-30  |  6KB  |  132 lines
  1.  
  2.  
  3.  
  4. SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrr((((3333))))                  IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                   SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrr((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SLGetSpooler, SLSetSpooler - gets/sets the default spooling system
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssppppoooooooollll....hhhh>>>>
  13.  
  14.      iiiinnnntttt SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrr((((uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt ****ddddeeeeffffaaaauuuullllttttpppp,,,,
  15.                       uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt ****aaaavvvvaaaaiiiillllaaaabbbblllleeeepppp))));;;;
  16.      iiiinnnntttt SSSSLLLLSSSSeeeettttSSSSppppoooooooolllleeeerrrr((((uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt ddddeeeeffffaaaauuuulllltttt))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _l_i_b_s_p_o_o_l library provides a common C language interface to two UNIX
  20.      print spooling systems, AT&T System V and BSD. The first _l_i_b_s_p_o_o_l
  21.      function called automatically determines which of the two spooling
  22.      systems is available and sets a default spooling system for use by
  23.      subsequent _l_i_b_s_p_o_o_l functions. The default spooling system set is
  24.      determined by the following table:
  25.  
  26.                            Available Spoolers   Default
  27.                            _____________________________
  28.                            None                 None
  29.                            BSD                  BSD
  30.                            System V             System V
  31.                            System V and BSD     System V
  32.  
  33.      A spooling system is considered available if the daemon for the spooling
  34.      system is found to be running on the system.
  35.  
  36.      The _S_L_G_e_t_S_p_o_o_l_e_r function returns the available spooling systems and the
  37.      currently set default spooling system. The _S_L_S_e_t_S_p_o_o_l_e_r function allows a
  38.      new default spooling system to be set for use by subsequent _l_i_b_s_p_o_o_l
  39.      functions. Note that each _l_i_b_s_p_o_o_l function automatically establishes a
  40.      default spooling system if one has not been set. Therefore, a call to
  41.      _S_L_S_e_t_S_p_o_o_l_e_r is necessary only when it is desired to set a spooler other
  42.      than the current default.
  43.  
  44.      _d_e_f_a_u_l_t_p       This is the currently set default spooling system that
  45.                     will be used by subsequent _l_i_b_s_p_o_o_l functions. The value
  46.                     is one of:
  47.  
  48.                     SL_SPOOLER_NONE   - No default currently set
  49.                     SL_SPOOLER_BSD    - BSD is default
  50.                     SL_SPOOLER_SYSV   - System V is default
  51.  
  52.      _d_e_f_a_u_l_t        This value specifies which spooling system is to be the
  53.                     default. The value is one of:
  54.  
  55.                     SL_SPOOLER_BSD    - Set BSD as default
  56.                     SL_SPOOLER_SYSV   - Set System V as default
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrr((((3333))))                  IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                   SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrr((((3333))))
  70.  
  71.  
  72.  
  73.      _a_v_a_i_l_a_b_l_e_p     This parameter indicates the spoolers currently available
  74.                     on the system. The available spooling systems are
  75.                     determined by the presence of the daemon for a given
  76.                     spooling system. The System V spooling system is
  77.                     considered available for use if the _l_p_s_c_h_e_d daemon is
  78.                     running. The BSD spooling system is considered available
  79.                     if the _l_p_d daemon is running.  _a_v_a_i_l_a_b_l_e_p is a bit mask of
  80.                     the available spooling systems. The value is one of:
  81.  
  82.                     SL_SPOOLER_NONE    - No spooling systems available
  83.                     SL_SPOOLER_BSD     - BSD spooling only
  84.                     SL_SPOOLER_SYSV    - System V spooling only
  85.                     SL_SPOOLER_BSD |
  86.                     SL_SPOOLER_SYSV    - System V and BSD available
  87.  
  88. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  89.      0 is returned if execution was successful. -1 is returned and _S_L_e_r_r_n_o is
  90.      set if an execution error has occurred.
  91.  
  92. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  93.      _S_L_G_e_t_S_p_o_o_l_e_r and _S_L_S_e_t_S_p_o_o_l_e_r will fail under the following
  94.      circumstances.
  95.  
  96.      SL_ERR_FIND_SPOOLER      An error occurred while attempting to determine
  97.                               the available printer spooling systems.
  98.  
  99.      In addition, _S_L_S_e_t_S_p_o_o_l_e_r will fail under the following circumstances.
  100.  
  101.      SL_ERR_SPOOLER_NONE      An invalid spooling system (e.g.
  102.                               SL_SPOOLER_NONE) has been specified as the
  103.                               default spooling system.
  104.  
  105.      SL_ERR_NO_SPOOLERS       There are no printer spooling systems available.
  106.  
  107.  
  108.      SL_ERR_SPOOLER_UNKNOWN   The spooling system specified is not available.
  109.  
  110.  
  111. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.      SLPerror(3), libspool(3), lpsched(1M), lpd(1M)
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.